
	Deep Junior Yokohama Chess Engines for Mac OS X
			 by Amir Ban & Shay Bushinsky
Copyright (c) 1996-2012 Amir Ban & Shay Bushinsky. All Rights Reserved.
			 http://www.hiarcs.com
			  18 November 2013

			 -------------------


Thank you for downloading the new Deep Junior chess engine for your computer.
We hope you will enjoy the product and will purchase it to activate the
full capabilities.

The following files are included in the Deep Junior Yokohama package:


1) DJMacLicense.txt    		- Please read before installing/using the Deep Junior product.
2) DJMacReadMe.txt		- This text.
3) Deep Junior Yokohama		- Deep Junior Yokohama UCI engine for Mac OS X.
4) jr13_portable.bin		- Internal opening book for Deep Junior.


			------------------


Background to Deep Junior Yokohama
==================================

Junior and Deep Junior are chess playing programs developed by Amir Ban and
Shay Bushinsky since 1994. 

In August 2013 Junior played in the World Computer Chess Championship in
Yokohama, Japan. It won the competition and received the title of world champion.
In the competition, Junior's enterprising style and the attractiveness of the games
it played was widely praised by competitors and spectators.

This was Junior's 7th world title, having won the World Microcomputer Chess 
Championship in 1997, and the World Computer Chess Championship
in 2001, 2002, 2004, 2006, 2009 and 2011.

The current release of Deep Junior Yokohama is of a program which is very similar,
but not identical, to the program that played in Yokohama.

Here are some changes in version Yokohama in relation to version 13:

- Several changes to evaluation, search and time management led to a stronger
  and more attractive engine.
- Several bugs, including one affecting playing strength, have been fixed.
- A learning feature has been added to the internal book, using the results of
  past games as a guide to choosing a line. This feature is especially of
  feature when playing a multi-game match against a single opponent.

These are some of the changes in version 13 in relation to version 12:

- Extensive revision of the code to optimize it for 64-bit operations,
including the use of "magic" bitboards.
- A revised and updated opening book.
- Improvement of the structure and logic of transposition tables.
- Improvements in search, including a better Singular Extension heuristic,
better LMR (Late Move Reduction) heuristics and better move ordering.
- More efficient algorithms for using multiple cores, supporting up to 40 
processors.

Deep Junior is a UCI engine. UCI stands for Universal Chess Interface and 
is used between a chess Graphical User Interface (GUI) and a chess engine. 
A variety of chess GUI support UCI and may be used to run Deep Junior Yokohama. 
A chess GUI is NOT included in this release.

			------------------


Acknowledgements
================

The opening book was compiled and prepared by Grandmaster Alon Greenfeld.

We thank Eugene Nalimov and Andrew Kadatch for their kind permission to use
their access code (copyright (c) Eugene Nalimov) and decompression code
(copyright (c) Andrew Kadatch) for Nalimov tablebases in the Deep Junior
engine.

THANK YOU!

			------------------



Deep Junior Engine Parameters
=============================

Opening Book Options
--------------------

OwnBook [Default = ON]
	Enables or disables Deep Junior's internal opening book.

Book_file [Default = jr13_portable.bin]
	Path name of Deep Junior's internal opening book. The path
	(unless fully qualified) is relative to the directory where
	the Deep Junior program is located.

Book selectivity [Default = 15]
	The minimum probability percentage to make an internal opening 
	book move playable. Moves with lower probability will not be played.
	This option may be used to control the selectivity of the (internal)
	opening book: Higher selectivity means that only the most common moves
	will be played. Lower selectivity means that Deep Junior will
	occasionally select less frequent moves.


Endgame Tablebases Options
--------------------------

Use_tablebases [Default = ON]
	Enables or disables the use of Nalimov's endgame tablebases.

NalimovPath [Default = /Library/TBs]
	Pathname of Nalimov tablebases directory.

NalimovCache [Default = 1]
	Size in megabytes of cache used by Nalimov endgame tablebases.


Play Options
------------

Threads [Default = number of computer cores]
	Sets the number of CPU cores (threads) that Deep Junior will utilize
	when thinking. The default is to use all available CPU cores. You
	may reduce this number in order not to utilize the full CPU resources
	of your computer (e.g. if you intend to run another CPU-intensive
	application in parallel to Deep Junior)

Hash [Default = 16]
	Sets the size (in megabytes) of the the transposition ("hash") table.
	The larger the hash table, the more effective Deep Junior's search
	(although the effect is not dramatic: A doubling of hash table size will
	result in a moderate increase in playing strength). If you attempt
	to set the hash size to more than the available memory, Deep Junior
	will automatically reduce this number, and will send the message
	"Hash size was reduced" to the GUI interface.

Clear_hash [Default = OFF]
	Controls whether the transposition ("hash") table is cleared before
	every move computed or analyzed. When this option is OFF (by default),
	some hash table contents from previous moves are retained.

Ponder [Default = ON]
	Controls whether Deep Junior will think on the opponent's time. If ON,
	Deep Junior will calculate its response on the opponent's time, on the
	assumption that the opponent will play the "Hint" move, i.e. a
	move that a previous search indicated is the opponent's likely best
	move. If eventually the opponent plays the hint move while Deep
	Junior "ponders", Deep Junior will smoothly continue thinking on its
	own time, and may play immediately if it judges that it thought enough
	about this move. If the opponent makes a move different than the hint
	move, Deep Junior discards its pondering and starts calculating its
	response to the actual move made. If Ponder is set to OFF, Deep
	Junior is idle during the opponent's time.

MultiPV [Default = 1]
	Sets how many alternatives to find in analysis mode: If MultiPV is set 
	to, e.g., 3, Deep Junior analysis will suggest a best move, a 2nd best
	move and a 3rd best move. The default is to suggest a best move only.

Contempt [Default = 0]
	Deep Junior's "contempt of draw", i.e. the extent to which it prefers
	to continue a game it considers level rather than draw. The value is
	expressed in centipawns (e.g. 25 is a quarter of a pawn). A negative
	contempt value means that Deep Junior prefers to draw rather than
	continue even with a slight advantage. Technically, Deep Junior's
	evaluates a draw as minus the contempt value. A positive contempt
	value is useful in avoiding quick chance draws against weaker opponents.

UCI_LimitStrength [Default = OFF]
	When ON, Deep Junior will limit its playing strength to approximately
	the level (measured as FIDE ELO rating) set in the UCI_ELO parameter.
	When this option is ON, Deep Junior will often play very quickly.

UCI_ELO {Default = 3000]
	When the UCI_LimitStrength paramaeter is set to ON, this sets the playing
	level (measured as FIDE ELO rating) which Deep Junior will try to
	approximate. If UCI_LimitStrength is not set to ON, the value of UCI_ELO
	is ignored.

			------------------


Purchase and Activation
=======================

In order to activate the full features of Deep Junior you must purchase the
Deep Junior product.


To purchase, visit http://www.hiarcs.com and select the Deep Junior link
and go to the "How to Buy" page. Follow the online instructions to
purchase at the secure online payment system.


After purchase please note the information in the purchase email carefully.
It may require some action on your part.  You will need a License Name and
Key to activate Deep Junior which will be emailed to you shortly after 
purchase.

			------------------


Further assistance
==================

For help and tips go to our web pages: http://www.hiarcs.com and read the
FAQ page for your product.

